home *** CD-ROM | disk | FTP | other *** search
- ******************
- ** INSTRUCTIONS **
- ******************
-
- The following are instrucions for setting up WAVPlayer for WebEx.
- Please make sure you have read and agree to the license agreement
- before using this program.
-
-
- INSTALLATION
- ============
-
-
- <SELECT LOCATION FOR PROGRAM FILES>
-
- To install this program, simply create a directory (eg.: "C:\WebWAV"),
- copy all files contained in this package into that directory.
-
-
- <EDIT SYSTEM FILES>
-
- Once you have copied the files into the directory of your choice, you
- must make sure the following references are added to your PATH and
- DPATH statements in your config.sys file:
-
- x:\WebWAV <---- or whatever the drive and directory are named
- that you installed the application in.
-
-
- <SET UP WEB EXPLORER TO USE THE BROWSER>
-
- Start WebExplorer, select "Setup" then "Viewers". Choose .WAV file
- and type WAVPLAY.EXE for the viewer name. You may do the same
- thing with .MID and any other audio file OS/2 and MMPM/2 support
- on your system (inotherwords, if you have an OS/2 plug-in for .au files
- that allows you to use any of the IBM OS/2 players or system
- commands to play it, this program will take advantage of it and play
- that type of audio file). Close WebExplorer to allow the changes to be
- saved. Make sure you did not have multiple copies of WebExplorer
- running when you changed your WebExplorer settings and exited.
-
-
- <SHUTDOWN AND RESTART OS/2 FOR CHANGES TO TAKE EFFECT>
-
- Once you have shut down OS/2 and reloaded it, you are ready to go.
- Wherever there is a link to a supported audio file, simply clicking
- on it will launch the Player.
-
-
- <ABOUT THE PROGRAM>
-
- The program, through the use of OS/2 system services and APIs,
- plays any MMPM/2 supported audio file. Thus, by adding support
- for a new audio file, our player will be capable of playing
- it. It does not launch the WAV Player that comes with OS/2,
- nor take as long to work.
-
- When you select a supported link, WebExplorer will load the file,
- pass it to the player (as a temp file in a format like "09x90900.WAV"
- or something similar. The player will launch and size itself to the
- top left of the screen, giving you 4 options:
-
- SAVE: Saves the file where specified and exits
- back to WebExplorer.
-
- PLAY: Plays the file and exits back to WebExplorer.
-
- SAVE n PLAY: Launches a separate thread to play the
- audio file and simultaneously asks where you
- want it stored and named.
-
- EXIT: Exit's with no action taken. The file will
- not be stored or played.
-
-
- <STOPPING THE FILE FROM PLAYING>
-
- The play action may be stopped one of two different methods
- depending on the choice you pick to initiate play. If you
- choose "PLAY", you can stop play by closing the player window
- by double-clicking the close button on the top left of the player window.
-
- If you choose "SAVE n PLAY", you must pull up your window
- list and shut down the player thread from there. "SAVE n PLAY"
- spawns a separate thread which we have named and added
- to the task list for this purpose. This method also works for
- the "PLAY" choice by selecting and stopping the main app
- from the window list.
-
- <FILES DO NOT PLAY>
-
- If a file does not play, generally the cause is the file is not
- supported by MMPM/2. If you have a third party player that supports
- the selected file, it does NOT make MMPM/2 enabled to support it.
- You need to have a plug-in codec either with it's own installation
- routine, or installed through the MMPM/2 installer to allow
- formats that were not supported with the base OS/2 product to be
- supported by our player.
-
- Another cause is another process that is locking the sound card.
- Usually, in this case, the player will wait till the card is avaiable and
- play the file then. Usually, it is a WinApp or FastLoad or such.
-
-
- <ABOUT THE PROGRAM>
-
- The program is re-entrant multitasking, multithreaded code
- (though part of the second thread is in an EXE file, it and it's
- shared code in the main process are spawned and maintained as a
- separate thread making calls to the same shared code in the DLL's).
- You may launch as many copies of it as you have resources to handle.
- The program does not share the sound card with other apps, though
- it is a simple change we are considering. It does work fine when other OS/2
- programs are using the sound card, though it will take over use to play
- the file and return use when finished. If more than one copy of the program
- are trying to play the file at the same time, whichever one has focus
- will play and the other will stop and wait.
-
- The program will automatically exit when it has finished it's task. If
- you selected "PLAY" you will notice this as the program shuts down
- and returns focus to WebExplorer or whatever app called it. If you
- selected "SAVE n PLAY", it will close the main window and let
- the thread close itself when playing is complete. The thread was
- dependent on the main process that called it, but we preferred this
- way, allowing a thread to be spawned to request, initiate and start
- the multimedia controls required, load the secondary player and
- pass the file info to it. The main process is calling the file dialog
- box and waits for an entry to save the file. This does not affect
- the player thread or secondary program.
-
- While the program is playing the audio file, you have full usage
- of the WebExplorer and may continue to browse through the web
- or even start other audio files loading. So far, we havent hit
- on a limit to the number of open players you may have.
-
-
- <REASON FOR THIS PROGRAM>
-
- We wrote this program for internal use and initially had it set
- up to load minimized (we created and registered a window and
- it's classes to allow an errant process to be shut down
- from the task list) and play the file and exit. One of the
- employees (Matt), in his enthusiam to make this difficult
- for what was supposed to be a ten minute app, suggested
- (annoyed the heck out of till I agreed??) that I add a SAVE
- capability and a PLAY button, hence it's current format.
-
- This program was written for internal use only as we were
- quite tired of waiting for OS/2's Audio Player to load, load
- the file, and then play it, wait for us to select exit, wait
- for it to shut down, etc, etc...
-
- Eventually (within 10 minutes of completion) we figured if
- this might be of interest to someone else and of any use,
- we might as well make it available for everyone. So, here
- it is!
-
-
- <ABOUT CYBERCOM>
-
- CYBERCOM is an OS/2 and computer (hardware and software)
- consulting company. We write custom OS/2 apps, do OS/2
- networking, installations and upgrades. We also are staffed with
- A+ Certified Service Technicians (certified for/by Compaq,
- HP, IBM, Toshiba, Acer, CompUSA/Compudyne and many others).
- Most of our employees are TeamOS/2 members and
- CYBERCOM is a pending IBM BESTeam member.
-
- Our current main programming project (non-Web related) is
- an accounting package designed from the ground up for OS/2,
- fully exploiting the following OS/2 technologies:
-
- Top tabs (Lotus infobox style)
- VoiceType Dictation and control
- Multiple threads
- Multiple printer usage and network printer support
- Multimedia usage for various parts of the application
- (such as "walk-through" help)
- Full integration with the WPS and fully object
- oriented interface
-
- The application will also provide many of the features found
- in it's WinXX counterparts, along with other features (some mentioned
- above) that cannot be easily or usably implemented
- on their 16bit OS platforms.
-
-
-
- CYBERCOM is located in Virginia and can be reached by email at:
-
- cybercom@erols.com
-
-
- Please drop us a line and let us know whether the WAV program
- is of any use to you - also feel free to comment on our other projects
- or any other programs you would like to see us write.
-
-
- This document (c) 1996 CYBERCOM
-
- WAVPlayer for WebEx (c) 1996 CYBERCOM and
- (c) 1995-1996 OnLine Data. All rights reserved.
-
-
-